Declare the jar and shadowJar dependencies of the test classpath - #11996

🏁 Script executed:

#!/bin/bash
set -eu
printf '%s\n' '--- changed hunk ---'
git diff -- gradle/shading.gradle
printf '%s\n' '--- shading.gradle ---'
cat -n gradle/shading.gradle | sed -n '45,80p'
printf '%s\n' '--- Gradle wrapper/version declarations ---'
fd -i 'gradle-wrapper.properties|gradle.properties|settings.gradle|settings.gradle.kts' . -x sh -c 'echo "--- $1"; cat -n "$1"' sh
printf '%s\n' '--- task declarations and output configuration ---'
rg -n -C 3 'shadowJar|tasks\.jar|jar\s*\{|archive(File|BaseName|Classifier|Version)|destinationDirectory|overlapping|duplicatesStrategy' --glob '*.gradle' --glob '*.gradle.kts' .

Repository: testcontainers/testcontainers-java

Length of output: 16264

🏁 Script executed:

#!/bin/bash
set -eu
printf '%s\n' '--- shading script ---'
cat -n gradle/shading.gradle | sed -n '1,75p'
printf '%s\n' '--- root build setup and plugin versions ---'
cat -n build.gradle | sed -n '1,180p'
printf '%s\n' '--- Shadow plugin declarations and script application ---'
rg -n -C 4 'com\.github\.jengelman|shadow|apply from|shading\.gradle|plugins\s*\{' build.gradle settings.gradle gradle core modules --glob '*.gradle' --glob '*.gradle.kts' --glob 'gradle.properties'

Repository: testcontainers/testcontainers-java

Length of output: 17934

🌐 Web query:

GradleUp Shadow plugin 8.3.9 shadowJar dependsOn jar default archiveClassifier null same output

💡 Result:

When you configure the Shadow plugin's shadowJar task to use an empty archiveClassifier (e.g., archiveClassifier.set("")), it forces the shadowJar task to produce a file name that is identical to the standard jar task's output (baseName-version.jar) [1][2]. This causes a conflict because both tasks attempt to write to the same location, potentially causing one to overwrite the other or leading to build errors regarding multiple artifacts with the same name [1][2][3]. To resolve this, you have three primary approaches: 1. Disable the standard jar task: If you only need the shadowed (fat) JAR, you can disable the default jar task [1][2]. tasks.jar { enabled = false } 2. Assign a different classifier to the standard jar: You can give the standard JAR a unique classifier so it does not collide with the shadowed JAR [1][2]. tasks.jar { archiveClassifier.set("plain") } 3. Use a different classifier for shadowJar: If you prefer keeping the default behavior, simply use a non-empty classifier for shadowJar (e.g., "all", "fat", or "shadow") [4][5]. Additionally, note that if you change the output file name to match other tasks (like those provided by the application plugin, such as startScripts or distZip), Gradle may report "implicit dependency" validation errors [6][7]. You must explicitly declare dependencies between these tasks to ensure the shadowed JAR is built before the dependent tasks attempt to use it [6][7]: tasks.named("distZip") { dependsOn(tasks.shadowJar) } Setting archiveClassifier to null or an empty string can also sometimes cause issues with publication tasks if multiple artifacts are seen as identical [8]. It is generally recommended to use an explicit string (like "") if you intend to replace the primary JAR, while being mindful of the resulting collisions [1][2].

Citations:

• 1: https://gradleup.com/shadow/publishing/
• 2: https://github.com/gradleup/shadow/blob/main/docs/publishing/README.md
• 3: https://stackoverflow.com/questions/70783680/why-is-gradle-generating-2-jars-after-update-to-gradle-7-3-2
• 4: https://gradleup.com/shadow/configuration/
• 5: https://stackoverflow.com/questions/55949702/how-to-specify-archive-classifier-for-shadowjar-plugin-in-gradle-5
• 6: GitHub issue 857 in johnrengelman/shadow (link omitted to avoid creating a cross-reference)
• 7: GitHub issue 921 in johnrengelman/shadow (link omitted to avoid creating a cross-reference)
• 8: GitHub issue 378 in GradleUp/shadow (link omitted to avoid creating a cross-reference)

🌐 Web query:

Gradle Project.files(Task...) task dependencies ordering overlapping outputs documentation Gradle 8.14

💡 Result:

In Gradle 8.14, the Project.files(Object...) method creates a FileCollection that tracks both the files it contains and the tasks that produce them [1][2]. When a FileCollection containing task outputs is used as an input to another task, Gradle automatically establishes an implicit task dependency [1][3]. Task Dependencies and Ordering Gradle uses both explicit and implicit dependencies to order task execution [4]. 1. Implicit Dependencies: By using a Task or FileCollection (representing task outputs) as an input, Gradle infers that the consuming task requires the producing task to run first [1][3][4]. 2. Explicit Dependencies: You can manually define ordering using properties like dependsOn or mustRunAfter [4][5]. 3. Limitation: Simply using the copy method or referencing a directory as an input does not always create an automatic dependency. For reliable dependency management, it is recommended to use the formal Task input/output API (@InputFiles, @OutputDirectory, etc.) or project-level file collections that link directly to tasks [6][3]. Overlapping Outputs Gradle detects when multiple tasks write to the same location (overlapping outputs) [7]. When this occurs: - Gradle may disable task output caching for the affected tasks to prevent incorrect cache entries [7]. - If Gradle cannot guarantee correct ordering, it may fail or prevent parallel execution of tasks targeting the same output directory [5][7]. - Official documentation strongly advises against having multiple tasks write to the same output directory [5]. Instead, you should configure tasks to use distinct output locations [5]. If shared files are necessary, use explicit task ordering (e.g., dependsOn) or ensure inputs and outputs are properly isolated [5]. For diagnostic purposes, running Gradle with the --info flag will provide details regarding why caching might be disabled or how tasks are ordered in the event of overlapping outputs [7].

Citations:

• 1: https://docs.gradle.org/8.14/javadoc/org/gradle/api/file/FileCollection.html
• 2: https://docs.gradle.org/8.14/javadoc/org/gradle/api/Project.html
• 3: https://docs.gradle.org/8.14/userguide/implementing_custom_tasks.html
• 4: https://docs.gradle.org/8.14/userguide/part2_gradle_tasks.html
• 5: GitHub issue 17961 in gradle/gradle (link omitted to avoid creating a cross-reference)
• 6: https://docs.gradle.org/current/userguide/working_with_files.html
• 7: https://docs.gradle.org/4.0/release-notes.html

🌐 Web query:

site:github.com/GradleUp/shadow "shadowJar.dependsOn(jar)" ShadowJar 8.3.9

💡 Result:

In the context of the Gradle Shadow plugin (including version 8.3.9), the statement shadowJar.dependsOn(jar) is a manual task dependency configuration [1][2]. By default, the Shadow plugin is designed to automatically handle project dependencies declared in your build configuration [3]. The shadowJar task is typically configured to include the output of the main source set and its runtime dependencies [3]. You would generally use shadowJar.dependsOn(jar) (or a similar construction) only in specific, non-standard scenarios, such as: 1. Custom Task Dependencies: If you have created a custom task (e.g., generating extra resources, copying files, or building another specific JAR) that must complete before the shadowJar task runs [1][2][4]. 2. Multi-project Builds: In some complex multi-project setups, you may need to explicitly force a dependency on a shadowJar task from another subproject to ensure that the required artifacts are available and up-to-date [4]. 3. Resolving Build Validation Warnings: If Gradle detects an "implicit dependency" warning where one task consumes the output of another without an explicit dependency declaration, adding a dependsOn configuration is a standard way to satisfy Gradle's task graph validation [5][4]. It is important to note that the shadowJar task does not automatically add itself to the standard Gradle build task [6]. If your intention is for the shadow JAR to be built whenever you run./gradlew build, you should configure that dependency explicitly [6]: tasks.build.dependsOn tasks.shadowJar For modern versions of the Shadow plugin (including 8.3.9), ensure you are using the correct plugin ID (com.gradleup.shadow) and that your configuration follows the plugin's documented practices for custom tasks and multi-project builds [7].

Citations:

• 1: GitHub issue 489 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 2: GitHub issue 41 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 3: GitHub issue 152 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 4: GitHub issue 713 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 5: GitHub issue 921 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 6: GitHub issue 335 in GradleUp/shadow (link omitted to avoid creating a cross-reference)
• 7: https://github.com/GradleUp/shadow

🌐 Web query:

site:gradleup.com/shadow 8.3.9 shadowJar jar dependsOn default task

💡 Result:

The shadowJar task, provided by the Shadow Gradle plugin, is an extension of the standard Gradle Jar task [1]. Because it inherits from the base Jar task type, it possesses the same task dependency mechanisms as any other Gradle task [1]. In Gradle, you can manage task dependencies for the shadowJar task using the standard dependsOn method [2][3]. For example, if you need the shadowJar task to depend on a custom task or another lifecycle task, you can configure it in your build script as follows: tasks.shadowJar { dependsOn(tasks.named("someOtherTask")) } The shadowJar task also has its own specific internal configurations. By default, it is configured to merge all dependencies from the project's runtimeClasspath or runtime configuration into the final JAR [4][5]. While it operates on these dependencies, it does not require special configuration to trigger standard task dependencies; you can simply use the standard Gradle API [2][1]. Regarding version 8.3.9, which was released on August 5, 2025, the release notes indicate performance improvements related to Zip file writing [6]. There were no noted changes in how task dependencies are defined or how the shadowJar task interacts with default Gradle tasks in that specific version [6].

Citations:

• 1: https://gradleup.com/shadow/configuration/
• 2: https://gradleup.com/shadow/api/shadow/com.github.jengelman.gradle.plugins.shadow.tasks/-shadow-jar/index.html
• 3: https://gradleup.com/shadow/api/shadow/com.github.jengelman.gradle.plugins.shadow.tasks/-shadow-jar/
• 4: https://gradleup.com/shadow/configuration/dependencies/
• 5: https://gradleup.com/shadow/api/shadow/com.github.jengelman.gradle.plugins.shadow.tasks/-shadow-jar/configurations.html
• 6: https://gradleup.com/shadow/changes/